PayPal Website Payments Pro

PayPal Website Payments Pro allows you to accept payments through PayPal directly on your website, using Visa, MasterCard, American Express, and Discover. It also allows you to accept PayPal payments if the customer wishes to pay with their PayPal account instead of paying directly with a credit card.

More information on PayPal Website Payments Pro can be found here:

https://www.paypal.com/cgi-bin/webscr?cmd=_wp-pro-overview-outside

In the diagram above, when the customer pays using a credit card directly on your website, Squirrelcart makes use of PayPal's Direct API method. When the customer pays using their PayPal account, Squirrelcart uses PayPal's Express Checkout method.

Express Checkout

With Express Checkout, your customer can bypass Squirrelcart's address form. They are sent to PayPal to choose a shipping address, and funding method. PayPal sends them back to your site to choose their shipping method and to complete payment.

Website Payments Pro has the following requirements:

• SSL Certificate
• CURL
• OpenSSL
• Expat

• As of this writing, only USD payments are possible with Website Payments Pro
• PayPal requires that you offer Express Checkout AND Direct (API) payments. Squirrelcart abides by this PayPal business requirement when you enable Website Payments Pro.
• Because Express Checkout must be offered, you cannot force the customer to create an account on your website (per PayPal's documentation). If Website Payments Pro is enabled, Squirrelcart will ignore the Force User Creation checkbox in your store settings if it is checked.

1. Sign Up
   You will need a PayPal Business account in order to use Website Payments Pro. If you do not have one, go to https://www.paypal.com  and click Sign Up. Be sure to choose a business account when signing up. After you sign up, you will receive an email with confirmation instructions. Confirm your account, and then continue below.
2. Apply for Website Payments Pro
   Navigate to Merchant Tools and select PayPal Website Payments Pro. Enter the required information about you and your business. You will be notified by email when your application review is complete; typically, applications are reviewed in one business day.
3. Add your bank account
   You must have a bank account added to your PayPal Business Account. If you do not have one, you can add one as follows:
   1. Log in to https://www.paypal.com
   2. Click Profile
   3. Under Financial Information, select Bank Accounts
   4. Enter your bank account information
4. Download a digital certificate
   1. Log in to https://www.paypal.com
   2. Click Profile
   3. Click API Access
   4. In the Request an API Certificate section, click API Certificate Request
   5. Fill out the fields on the form. Towards the bottom of the page, you will see an API account name that has been generated for you. Write this account name down. You will be prompted to enter a password for this account. Write your password down as well. Click the Continue button.
   6. On the next page, click Generate Certificate
   7. Click the Download button to download the API certificate. When prompted to save the file, save it to your computer and make note of the location that you saved it to.
5. Upload certificate file
   
   1. Rename the file you downloaded to paypal_cert_key.pem
   2. Using FTP, upload the certificate file to your webserver. For security reasons, we recommend you upload it to a location that is above your web root folder so it is not web accessible. The sc_data folder is a good location for this, provided that you have Squirrelcart configured so that the sc_data folder is above your web root.
6. Open the PayPal Website Payments Pro record in Squirrelcart
    
7. Enter your API account name in the Account Name field
8. Enter your API password in the Account Password field
9. Enter the full server specific path to your certificate file, including the file name. Examples of paths are:
   /home/youraccount/sc_data/paypal_cert_key.pem
   C:/youraccount/sc_data/paypal_cert_key.pem
10. Choose your transaction type using the Transaction Type field. Mouse over the field name for more information.
11. Check the Enabled field
12. Set the PayPal Mode field to Live
13. If you do not wish to gather shipping address information from PayPal, check the No Shipping field
14. Click

PayPal's Instant Payment Notification allows you to integrate PayPal payments with Squirrelcart's order management feature. IPN provides immediate notification and confirmation of PayPal payments you receive, and allows Squirrelcart to update the payment status on orders in your database. If you activate IPN, you will receive an IPN when a payment is first received, which will display the status of the payment (Completed or Pending). If the payment status was Pending, you will receive another IPN when the payment clears, fails, or is denied.

Enabling IPN

1. Open the PayPal Website Payments Pro record in Squirrelcart
   
2. Check the IPN field
3. If you wish to receive an email from Squirrelcart each time an IPN is received from PayPal, check the Test IPN field
4. Click

© 2001-2005 Lighthouse Development. All Rights Reserved.